@Number List@<:#284,9025><+!>Converting Existing AmiPro files to HTML<-!>
@Standard Text@<:I0,0,0,0><:#284,9025>
@Standard Text@<:I0,0,0,0><:#284,9025>
@H3@<:I0,0,0,0><:#422,9025>1. Installing the Tools
@Standard Text@<:I0,0,0,0><:#568,9025>This set of tools combine to make a simple HTML document creator for AmiPro. The components are:
@Standard Text@<:I0,0,0,0><:#284,9025>
@Number List@<:I360,360,360,0><:#573,9025><+!>The Ami Style Sheet :<-!> "_HTML.STY" which should be placed in the Styles directory of the AmiPro installation.
@Number List@<:I360,360,360,0><:#573,9025><+!>The Macros File:<-!> "HTMLMACS.SMM" which should be placed in the AmiPro Macros directory.
@Number List@<:I360,360,360,0><:#289,9025><+!>The File Converter:<-!> "WN_SM2HT.EXE" which should be placed in the AmiPro.
@Number List@<:I360,360,360,0><:#857,9025><+!>The Icons and SmartIcon File:<-!> All the files ending with .BMP and the file HTML.SMI need to be placed in the AmiPro Icons directory. To use the icons, select Tools/SmartIcons and HTML from the pull down menu at the top of the dialog box.
@Standard Text@<:I0,0,0,0><:#284,9025>
@Standard Text@<:I0,0,0,0><:#284,9025>Once these are set in their correct places the toolkit is ready for use.
@Standard Text@<:I0,0,0,0><:#284,9025>
@H3@<:I0,0,0,0><:#422,9025>2. Using the Tools
@Standard Text@<:I0,0,0,0><:#568,9025> From the AmiPro File menu select New, this will bring up the Style Sheet dialog box. From the list select the HTML style sheet, this has the description:
@Standard Text@<:I0,0,0,0><:#284,9025>
@Standard Text@<:I0,0,0,0><:#284,9025> HTML - Used for creating HTML documents
@Standard Text@<:I0,0,0,0><:#284,9025>
@Standard Text@<:I0,0,0,0><:#284,9025> or is listed by its filename:
@Standard Text@<:I0,0,0,0><:#284,9025>
@Standard Text@<:I0,0,0,0><:#284,9025> _HTML.STY
@Standard Text@<:#284,9025>
@Standard Text@<:#284,9025> Before clicking OK ensure that the "Run Macro" and "With Contents" boxes are checked.
@Standard Text@<:#284,9025>
@Standard Text@<:#852,9025> After a short delay, as the initialisation macros are processed, the blank page appears and you should find that a new item is added to the toolbar with the name HTML. This has a number of items in it most of which are for creating the document featur
@Standard Text@<:I0,720,720,0><:#852,9025>Highlight the text that you wish to attach the link to and select this option, you will then be asked for the URL of the link. Once you enter this data the anchor is added to the text.
@Standard Text@<:I0,720,720,0><:#284,9025>
@Standard Text@<:I0,720,720,0><:#284,9025><+!>Add NAME Anchor (Hotkey CTRL+SHIFT+N)<-!>
@Standard Text@<:I0,720,720,0><:#1420,9025>This is for placing labels in the text so you can access a section of an HTML document. Highlight the text that you wish to attach the anchor to and select this option, you will then be asked for a name for the anchor which will be added to the text.
@Standard Text@<:I0,720,720,0><:#1420,9025>This is for placing images in an HTML document. Select this option and you will be asked for the URL of the image, you may select the alignment of the image with the text and add text that will be displayed on browsers that do not support images. You may
also indicate whether the image is an image map. The image will not be displayed in AmiPro.
@Standard Text@<:I0,720,720,0><:#568,9025>This places the <<NOBR<;><</NOBR<;> tokens around the highlighted text which indicate that the line must not be in this section.
@Standard Text@<:I0,720,720,0><:#852,9025>This places the <<WBR<;> token in the text which indicates that the line may be broken at this point in the middle of a NOBR section. It may also be used anywhere in the text to indicate where a word may be broken.
@Standard Text@<:I0,720,720,0><:#852,9025>A dialog box appears for you to enter your name, e-mail address and home page. This information will be added into the text at the cursor position with a link to your home page from your name. Your e-mail address will be in ADDRESS format.
@Standard Text@<:#1988,9025>This allows the user to select a different paragraph style. These styles are used by AmiPro to mimic the display of a browser and are used by the converter to set the desired style in the HTML document. There is the standard text style used for most of th
e body text of the HTML document, the six heading styles H1-H6, three depths of lists, number lists, directory lists and menu lists. There are also Program Code, Block Quote, and PreFormatted styles and Definition and Defn Text styles. Note that Definitio
n and Defn Text styles altenate between new lines.
@Standard Text@<:#284,9025><+!><+#><-!><-#>
@Standard Text@<:#284,9025><+!><+#><++>Text Styles <-+><-#><+#>and<-#><+#><++> Text Effects<-+><-#><-!>
@Standard Text@<:#568,9025>These simply add appropriate markers around the selected text so that the desired effect is entered into the document.
@Standard Text@<:#568,9025>If the file has not been given a filename then before anything the Save dialog box will come up for you to save the source file.
@Standard Text@<:#1136,9025>Next, another dialog comes up which prompts you for a destination directory and a filename for the converted file. Enter or verify these and press OK and the file will be converted. This dialog box may be disabled after the first conversion by selecting '
Don't show Convert dialog box' in the Options dialog box.
@Standard Text@<:#852,9025>Any errors from the conversion will be displayed in a window. Because of the way the file is converted, these error messages are unfortunately not extremely helpful but they give you some idea as to what is wrong with the file.
@Standard Text@<:#284,9025>NOTE: The source file is saved every time the file is converted.
@Standard Text@<:#568,9025>This dialog box is mainly for NetScape extensions but it also includes the CheckBox for disabling the Convert File dialog box.
@Standard Text@<:#568,9025>There are three main other parts; the HR extensions, the BR extension. These are the values that will be used when the NetScape options are enabled.
@Standard Text@<:#568,9025>The third is the CheckBox to enable NetScape Extensions and this enables the BR and HR extras and an extended options dialog box for images.
@Standard Text@<:#284,9025>For an explanation of these please see:
@Standard Text@<:#284,9025><:f240,2Times New Roman,255,0,0>http://home.mcom.com/home/services_docs/html-extensions.html<:f>
@Standard Text@<:#284,9025><:f240,2Times New Roman,255,0,0>
@Standard Text@<:#284,9025><+!>Please Note:<-!>
@Standard Text@<:#568,9025>Anchors and other bracketed '<< <;>' items MUST appear in red or the brackets will be converted to their HTML codes << becomes < and <;> becomes > .
@Standard Text@<:#284,9025>
@Standard Text@<:#284,9025>
@H3@<:#422,9025>3. Current NetScape capabilities
@Standard Text@<:#568,9025>I am working to make AMIWEB capable of using the extensions to HTML that are included in NetScape.
@List@<:#284,9025>Fontsize processing to allow variable font sizes in documents.
@List@<:#284,9025>All the new image attributes.
@List@<:#284,9025>The new <<HR<;> and <<BR<;> attributes.
@List@<:#284,9025>The new elements <<NOBR<;> and <<WBR<;> for what they're worth.
@Standard Text@<:#284,9025>
@Standard Text@<:#568,9025>I have no intention of adding the following due to the difficulties with representing them in AmiPro:
@List@<:#284,9025>Different bullet types in lists
@List@<:#284,9025>The initial count value in ordered lists and the counting format ie. 1,2,3 or i, ii, iii etc.
@Standard Text@<:#284,9025>
@Standard Text@<:#284,9025>
@H3@<:#422,9025>4. Converting existing documents to AmiWeb
@H3@<:#422,9025>documents
@Standard Text@<:#568,9025> To convert an existing document to a form that amiweb can process load your document then from the style option select 'Use another style' and select the HTML style.
@Standard Text@<:#852,9025> The next thing to do is to select Macros from the Tools option and Playback. Select the macro called HTMLMACS.SMM and run it, this will set up the macros in the document for future use.
@Standard Text@<:#1136,9025> Once you have done all this, you must go through the document changing any Paragraph Styles that are not included in the HTML style sheet to ones that are. To do this simply highlight the areas to change and select the appropriate paragraph style from the
menu activated by clicking on the button at the bottom left of the AmiPro screen.
@Standard Text@<:#852,9025>On converting the document, any styles that are not recognised will send up an error message naming the offending styles. Search through the document for these styles and change the occurrences to acceptable styles.
@Standard Text@<:#284,9025>
@Standard Text@<:#284,9025>
@H5@<:#360,9025>Any bugs, comments:
@Standard Text@<:#852,9025>Please inform me of any bugs you find or any comments you have to make about these tools. I cannot guarantee that any recommendations will be followed up but I will endeavour to fix any bugs.
@Standard Text@<:#284,9025>
@Standard Text@<:#284,9025>e-mail to sbx@cs.nott.ac.uk 23/3/95